E-WMS

Installation and configuration of Microsoft IIS for E-WMS ASP on Windows Server 2008

This document describes the steps to install and configure Microsoft IIS for WMS ASP on a Windows 2008 (32 bit or 64 bit) server, per release 411.

For configuring IIS for release 410 or earlier on a Windows 2008 server, please see this document.

This document consists of following sections:

Installation of IIS
Configuration of IIS
- Create application pool
- Create WMS web application

Installation of IIS

Server prerequisites

It is assumed that the E-WMS ASP files are available in a dedicated E-WMS ASP folder
Microsoft .NET Framework 4.5 has to be installed
"Visual C++ Redistributable Packages for Visual Studio 2013" (vcredist_x64.exe) has to be installed. You may have to download this package on another PC than the server itself.

Install these components before installing and configuring IIS.

Install Microsoft IIS

Go to Windows menu [Start, Settings, Control Panel, Programs and Features]
Click in the left panel on Turn Windows features on or off, this will start the Server Manager
Click on Roles on the left:
Click on Add roles on the right, press next if you see the "Before you begin" screen
The screen "Select Server Roles" appears, select Web Server (IIS) and press Next
You may see this message pop up, click Add required features
Press Next in the screen "Web Server IIS" which starts with "Introduction to Web Server (IIS)".
In the screen "Select Role Services' check the options shown below.
(if a pop-up screen appears, acknowledge with Add Required Role Services)

Required options for E-WMS are: all ASP related options, "Static content". E-WMS uses 'Anonymous authentication'.
"IIS 6 scripting tools" can be added for management and trouble shooting.
After making your choices, press Next and Install. When done, the screen "Installation Results" will show. Press Close.

Configuration of IIS

Go to Windows [Start, Settings, Control panel, Administrative tools, Internet Information Services (IIS) Manager] (or: Start/RUN, Inetmgr) to start the IIS manager.

WMS ASP requires ASP.NET (.NET Framework 4.5.x) and configured for 'integrated managed pipeline mode' to run properly. This is managed in IIS by 'application pools'.

You can select an existing application pool with these configuration options, or create one specific for E-WMS ASP.

Create a new Application Pool

Expand the server name, Right click on "Application Pools" and select Add Application Pool. Assign a specific name to the application pool, for instance E-WMS.

Set .NET to the required version for E-WMS: '.NET Framework v4.0.x' and leave 'Managed Pipeline Mode' at 'Integrated':

Press OK to save this new Application Pool.

If you just installed .NET Framework 4.5 but this version is not listed here in available .NET framework versions, then first reboot the server.

Create E-WMS web application

Expand the server name, expand "Sites", expand "Default web site"
An application pool is required to configure that E-WMS ASP is running on .NET Framework 4.5.
You can change the IIS default application pool accordingly, or create a new specific application pool for E-WMS.

To create the E-WMS web application:
Right-click on "Default web site", choose Add application, enter the preferred name (alias) for E-WMS, like "wms".
This is the name that will be used to open the WMS web site on the scanners, for instance 'http://webserver/wms'.

At 'Physical path', browse to the folder where the E-WMS ASP files are located; for example C:\WMS.
At 'Application pool', select the application pool created earlier for E-WMS, or leave at 'DefaultAppPool' when the default application pool was changed to run .NET Framework 4.5:

Press OK.

Now click on your new web site name on the left, in the center panel the web configuration icons will show.

Authentication

Double click the icon Authentication, verify whether 'Anonymous authentication' is enabled and other types are disabled.

Press the back button to return to the main configuration screen.

Regional settings (optional)

Double-click the configuration option ".NET Globalization" :

Choose your preferred regional settings. For example, selecting "En-US" will enable the decimal point (".") as decimal separator, selecting "Dutch NL-NL" will enable the comma as decimal separator on the mobile device. This setting applies for entry of quantities using decimals, or dates, on the mobile devices. This setting has to be re-configured after each E-WMS update (to be specific: due to overwriting the file Web.config during an update).

Test web site

You can test the web site from within the IIS manager.

Start IIS manager, expand to the E-WMS web site, right click on the site, Manage Application, Browse, or click on the WMS web site name and select 'Browse *:80 (http)' in the far right panel.

This will start Internet Explorer for this site. You can also start IE on the server and browse to http://localhost/wms (replace 'wms' with your own web site alias).

When you the screen below, the web site works. You can close Internet Explorer.

The next test would be to start WMSclient on a scanner or on a PC and connect to the web site.

To test the proper workings of WMSclient, you have to login on the scanner and start a scan screen, for instance transfers, or stock info.